package com.example.forum.services;

import com.example.forum.model.Message;
import org.apache.ibatis.annotations.Param;
import org.springframework.transaction.annotation.Transactional;

import java.util.List;

public interface IMessageService {

    /**
     * 发送站内信
     * @param message
     */
    void create(Message message);

    /**
     * 根据用户id 查询该用户站内信未读数量
     * @param receiveUserId  用户id
     * @return  数量
     */
    int selectUnreadCount(Long receiveUserId);


    /**
     * 根据接收者id 查询所有站内信
     * @param receiveUserId  接收者id
     * @return List<Message>
     */
    List<Message> selectByReceiveUserId(Long receiveUserId);

    /**
     * 更新指定站内信状态
     * @param id  站内信id
     * @param state  目标更新状态
     */
    void  updateStateById(Long id,Byte state);

    /**
     * 根据id查询对应的站内信
     * @param id  站内信id
     * @return
     */
    Message selectById(Long id);

    /**
     * 标记用户所有站内信为已读
     * @param userId 用户ID
     */
    @Transactional
    void markAllAsRead(Long userId);

    /**
     * 删除站内信（逻辑删除）
     * @param id 站内信ID
     */
    void deleteMessage(Long id);

    /**
     * 回复站内信
     * @param repliedId  站内信id
     * @param message 回复内容
     */
    @Transactional
    void reply(Long repliedId,Message message);

    /**
     * 根据接收者id和参数查询站内信
     * @param receiveUserId 接收者id
     * @param queryParam 查询参数（包含状态、类型等）
     * @param offset 分页偏移量
     * @param limit 分页大小
     * @return 符合条件的消息列表
     */
    List<Message> selectByReceiveUserIdWithParams(Long receiveUserId, Message queryParam, int offset, int limit);

    /**
     * 根据接收者id查询站内信并包含发送者信息
     * @param receiveUserId 接收者id
     * @return 消息列表（包含发送者用户信息）
     */
    List<Message> selectByReceiveUserIdWithUserInfo(Long receiveUserId);

    /**
     * 获取用户各类型消息数量
     * @param receiveUserId 用户ID
     * @return 各类型消息数量
     */
    java.util.Map<String, Integer> getCategoryCounts(Long receiveUserId);

    /**
     * 根据消息类型标记为已读
     * @param userId 用户ID
     * @param type 消息类型
     * @return 更新的消息数量
     */
    int markReadByType(Long userId, String type);
}
